home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 12 / BBS in a box XII-1.iso / Files / Util / Sd-Sp / Serial Mouse 1.01.sit / Serial Mouse 1.01 / MeeseDocs II.txt < prev    next >
Encoding:
Text File  |  1994-01-07  |  5.5 KB  |  125 lines  |  [ttro/ttxt]
  1. Serial Mouse Driver
  2. ©1992, 1993 Charles Rentmeesters
  3.  
  4. CDware.  If you use this software, you've probably saved a bundle on getting a 
  5. IBM type serial mouse, so spend a few bucks more and send me a CD.  Either 
  6. Musical CD's or CDROM's.  Send me something unique, send me something 
  7. original.  If you're in a foreign country send me a CD in your native language.  
  8. Of course, if you don't have the time to send me a CD, a donation of about $10 
  9. is just as accepted.
  10. Send to:
  11.     Charles Rentmeesters
  12.     410 N Carroll St
  13.     Madison, WI 53703-1804
  14.     USA
  15.  
  16. I'd love to hear your suggestions.  Email address:
  17.     rentmees@cae.wisc.edu
  18.  
  19. What is it?
  20. This cdev/init allows you to connect a IBM type serial mouse to your 
  21. Macintosh, and use that instead of the standard Macintosh mouse.  It works 
  22. with Microsoft and Mouse Systems compatible mice.  (just about the only two 
  23. types of serial mice that are out there).  You can even use IBM type serial 
  24. trackballs with it!  Connect the mouse up to one of the serial ports of your 
  25. Macintosh, and drop this cdev/init into your System folder.  Use the control 
  26. panel or System 7 to set-up the mouse driver.  This allows you to set up 
  27. which port the mouse is connected to, and what type of mouse it is.  It also 
  28. allows you to modify the event the mouse sends for each of the mouse 
  29. buttons.  Software written using the Symantic Think C compiler, and tested 
  30. on a Macintosh IIci running system 7.1.
  31.  
  32. Connecting up the Serial Mouse:
  33. To connect the serial mouse up to your Macintosh, you will need a serial 
  34. cable.  Some serial mice can just use a standard modem serial cable that you 
  35. can buy from many computer stores.  If that doesn't work, you can make your 
  36. own serial cable for the mouse. A common symptom of not working with the 
  37. standard serial modem cable is that the mouse buttons will work, but the 
  38. mouse will not move.  This happens when the mouse in question requires 
  39. that there be power on RTS and DTR line, which the standard serial mouse 
  40. cable does not provide.
  41.  
  42. This is the standard pinouts for a serial mouse cable:
  43. (looking at the cable, with male connectors on both ends)
  44. Macintosh
  45. 8 minidin
  46. Pin #    Macintosh
  47. Description    RS232
  48. Name    Mouse
  49. db9
  50. Pin #    Mouse
  51. db25
  52. Pin #
  53.                            
  54. 1    Handshake Out    RTS    7    4
  55. 1    Handshake Out    DTR    4    20
  56. 2    Handshake In    CTS    8    5
  57. 3    Transmit Data    TD    3    2
  58. 4    Ground    GND    5    7
  59. 5    Receive Data -    RD    2    3
  60. 8    Receive Data +    GND    5    7
  61.  
  62. Helpful hints:
  63. When installing the mouse driver, be sure you have a back-up way to move 
  64. the mouse in case you don't get it to work right away.  Either keep your old 
  65. ADB mouse connected, or have Easy Access installed in your system.  Also, 
  66. terminal programs which are set-up for the same port as the Serial Mouse 
  67. Driver is set up for may crash.  When making the serial cable, it's easy to buy 
  68. a Macintosh serial cable, and cut it in half and then solder the db9 connector 
  69. to the cut end.  That way you don't have to do any soldering to a 8pin mini-
  70. din.
  71.  
  72. Serial Mouse Protocol (for Mouse Systems Mice):
  73. Events are sent in 5 byte packets at 1200 baud.  The first byte is a sync byte, in 
  74. the format 10000LMR, anding any byte with $F8 and then comparing to $80 
  75. will tell you if it's the sync byte.  The bits L, M, and R and the status of the 
  76. mouse buttons.  1 = button up, 0 = button down.  The second byte in the 
  77. packet is the horizontal change in pixels.  The third byte is a vertical change.  
  78. The fourth and fifth bytes are horizontal and vertical change bytes 
  79. respectively.
  80.  
  81. Serial Mouse Protocol (for Microsoft Mice):
  82. Events are sent in 3 byte packets at 1200 baud.  The first byte is a sync byte, in 
  83. the format 11LRYYXX, anding any byte with $C0 and then comparing to $C0 
  84. will tell you if it's the sync byte.  The bits L, and R and the status of the mouse 
  85. buttons.  0 = button up, 1 = button down.  YY is the most significant two bits of 
  86. the vertical movement.  XX is the most significant two bits of the horizontal 
  87. movement.  The second byte in the packet has the format 10XXXXXX.  These 
  88. are the lower 6 bits of the horizontal movement.  This must be combined 
  89. with the two bits in the sync byte to get the value for the horizontal 
  90. movement.  The third byte is of the format 10YYYYYY.  This is the lower 6 
  91. bits of the vertical movement.  This must be combined with the sync byte like 
  92. the horizontal movement to get the value for the vertical movement.
  93.  
  94. Changes in version 1.0.1:
  95. •    Bug fixed that caused crash in systems earlier than system 7.  (And system 
  96. 7 too, but you really had to do work to get it to do it!)
  97. •    Improved Documentation.
  98. •    Version display added to lower right corner of control panel.
  99. •    Double-click mouse event added to types of events.
  100. •    Color Icons added.
  101. •    Now type of mouse option is updated immediately instead of waiting for 
  102. the user to reboot each time after changing.  (Note: you still have to reboot 
  103. each time to change the port that it uses.)
  104.  
  105. Future ideas for the mouse driver:
  106. I'm thinking about making a hardware solution to the problem as well, so 
  107. that you can hook the serial mouse up to a converter connected to the ADB 
  108. port.  Another idea is to make an ADB converter for IBM AT compatible 
  109. keyboards.
  110.  
  111. Comment:
  112. Early 93 I made a IBM AT keyboard to Mac Keyboard converter.  It works for 
  113. ADB Macs as well as the Mac Plus.
  114.  
  115. Other software by me:
  116. "Chuck's Printer Driver"  -- Allows you to connect an Epson compatible 9-pin 
  117. or 24-pin printer up to your Mac.
  118.  
  119. Disclaimer:
  120. I take no responsibility for anything you my do to damage or destroy your 
  121. Mac.  This software is used at your own risk.  Microsoft, Mouse Systems, 
  122. Epson, Macintosh, Think C, and any other trademarks are copyright of their 
  123. respective owners.
  124.  
  125.